revShowPrintDialog
Type
command
Summary
Controls display of the Page Setup (on Mac OS systems) and Print dialog boxes when using the revPrintField or revPrintText commands.
Syntax
revShowPrintDialog <showPageSetup>, <showPrint>
Description
Use the revShowPrintDialog command to let users specify options for printing.
Before printing, applications usually display a dialog box where the user can set certain print-related properties. (This dialog is displayed by the operating system, not by LiveCode.) Typically, the options in the dialog box include enlargement or reduction, landscape or portrait mode, and paper size, but the exact options are determined by the printer driver and the operating system. If you use the revShowPrintDialog command in a handler before a revPrintField or revPrintText command, these commands display this dialog box.
On Mac OS and OS X systems, the showPageSetup parameter controls whether the Page Setup dialog box appears, and the showPrint parameter controls whether the Print dialog box appears. On Windows systems, the showPageSetup parameter controls whether the standard printing options dialog box appears, and the showPrint parameter is ignored.
If you use the revShowPrintDialog command outside a handler where a revPrintField or revPrintText command is executed, the revShowPrintDialog command has no effect. The command sets printing options only for the currently executing handler.
The revShowPrintDialog command is part of the Printing library. To ensure that the command works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "Printing" library checkbox is checked.
Parameters
| Name | Type | Description |
|---|---|---|
showPageSetup | bool | |
showPrint | bool |
Examples
revShowPrintDialog true,true -- shows both dialogs
revShowPrintDialog false,true -- shows only Print dialog
revShowPrintDialog false,the hilite of button "Set Options"
Related
command: answer printer, revPrintText, group, revPrintField, answer page setup
function: result
glossary: application, standalone application, dialog box, execute, command, Windows, main stack, OS X, Standalone Application Settings, Mac OS, message, parameter, handler, LiveCode custom library
library: Printing library
message: startup, openBackground, preOpenStack, openStack, preOpenCard
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
Platforms
desktop